Sokoban for the Macintosh, version 1.0 by Scott Lindhurst
What is Sokoban?
Sokoban is basically a puzzle game. The object is to push treasures into safe places. What makes it hard is that you can only push one at a time (they╒re too heavy to push two at once), and there are no handholds (you can only push, not pull). So you have to make sure that you don╒t get a treasure stuck in a corner, or that you don╒t get two of them stuck against each other. It will usually take some thought (maybe quite a bit) to figure out how to solve a level. But all 85 levels are solvable. And you can make more when you get tired of the ones included.
How do I play?
To start playing, select New Player╔ from the Players menu, and make an entry for yourself. Sokoban will keep track of which levels you have solved in the ╥Sokoban Scores╙ file in the Preferences folder (under system 7), or in your System Folder (under previous systems).
The first level looks like this:
╩
The treasures are the round things lying all over the place, and your job is to push them to the shaded squares. There are several ways to move. The easiest way is to use the arrow keys to move up, down, left, or right. Shift-arrowkey will move you as far as possible in that direction, including pushing treasures. Option-arrowkey (also control-arrowkey, if you have a control key) will move you as far as possible without pushing.
Instead of using the arrow keys, you can also use the traditional ╥vi keys╙ h, j, k, l to move left, down, up, right respectively (those are the keys used by the Unix version). The last set of keys is the numerals 2, 4, 6, 8 on the numeric keypad. Of course, shift, option, and control work with both of these.
You can also use the mouse to move. The cursor indicates which way you╒ll move if you press the button. Shift clicking will move you to where you clicked by the shortest route (or yell at you if there╒s no way to get there.)
Last, and probably least, is the Movement menu. It works, but is much less convenient than the keyboard or mouse.
There are also several menu items that will help you. From the File menu, you can restart the level if you get stuck. You can also make a temporary save before you mess up, and revert to it when you get stuck later. Or if you╒re really stuck, you can move on and try another level, then come back later and work on the unsolved levels.
The Edit menu will let you undo (and then redo) up to 100 of your last moves. So a couple of extra key presses in the heat of playing doesn╒t mean having to start the level over.
If you want to design your own levels, it╒s easy. You just create a text file in your favorite word processor (use a monospaced font like Monaco), and then use the Play Screen From File╔ command in the File menu to try it out. For example, this is a file for level 1, along with an explanation of the symbols to use (the actual file is also included in the archive for your information):
╩
There is a limit of 30 columns and 17 rows (that╒s 10 columns and 1 row more than any of the included levels use). Additional rows and columns will be ignored. If you make your own screens, send them to me and I╒ll include them in the next release of the program.
Some History
Sokoban has been available in the public domain for MS-DOS and Unix machines for several years. The version I first played only had levels 1╨50. Then Joseph L. Traub (jt1o@andrew.cmu.edu) collected another 35 levels and included them with his version for XWindows. Those are levels 51 to 85.
Freeware (CommentWare? BugWare?)
Sokoban is Freeware. However, I would like to know if you like it. Send me comments, criticisms, features you would like, and bug reports. If you╒re the first to report a given bug or if you make good suggestions, I╒ll thank you in the about box of the next version of Sokoban.
You may distribute Sokoban unmodified as much as you want, as long as this documentation file is included. Sokoban is copyright 1991╨1992 by me, Scott C. Lindhurst, so if you try to claim it as your own, I╒ll get mad. Source code may be available if you ask nicely and don╒t mind the occasional bad style.
About the Author
I╒m a grad student in mathematics. Programming has been a hobby of mine since my parents got an Apple ][+ almost 10 years ago. When I got my Mac Plus, I wanted to learn all about it. Eventually (after about 4 years and some minor projects), I decided to implement Sokoban and finally learn about programming with the Macintosh toolbox. And it worked. So if you want to hire someone working his way up the Mac learning curve (programming in Think Pascal, including some Object Pascal; I also like LISP), I╒m available at least part time while I╒m in school. Drop me a line.
Sokoban was written in Think Pascal 3.0, on a Mac Plus running System 6, then System 7. It has been tested on many Macintosh models, color and no color, System 6 and 7. It will even work on System 4.1, the oldest one I have.
